home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 5 / BBS in a Box -Volume V (BBS in a Box) (April 1992).iso / Files / Apple / Apple II TNs(Text).cpt / Apple II TNs(Text) / GSOS / TN.GSOS.004 < prev    next >
MacBinary  |  1989-11-15  |  8.4 KB  |  [TEXT/pdos]
open in: MacOS 8.1     |     Win98     |     DOS

browse contents    |     view JSON data     |     view as text


This file was processed as: MacBinary (archive/macBinary).

ConfidenceProgramDetectionMatch TypeSupport
10% dexvert MacBinary (archive/macBinary) fallback Supported
1% dexvert GeoWorks GEOS Data (other/geoWorksGEOSData) ext Unsupported
1% dexvert Text File (text/txt) fallback Supported
100% file MacBinary II, inited, Wed Nov 15 12:34:06 1989, modified Wed Nov 15 12:34:06 1989, creator Apple ProDOS file system, type ASCII, 7940 bytes "TN.GSOS.004" , at 0x1f84 382 bytes resource default (weak)
99% file data default
74% TrID Macintosh plain text (MacBinary) default
25% TrID MacBinary 2 default (weak)
100% siegfried fmt/1762 MacBinary (II) default
100% lsar MacBinary default


id metadata
keyvalue
macFileType[TEXT]
macFileCreator[pdos]


hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 0b 54 4e 2e 47 53 4f | 53 2e 30 30 34 00 00 00 |..TN.GSO|S.004...|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 70 64 6f | 73 01 00 00 00 00 00 00 |.TEXTpdo|s.......|
|00000050| 00 00 00 00 00 1f 04 00 | 00 01 7e a1 87 4e 8e a1 |........|..~..N..|
|00000060| 87 4e 8e 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.N......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 f2 e7 00 00 |........|........|
|00000080| 41 70 70 6c 65 20 49 49 | 0d 54 65 63 68 6e 69 63 |Apple II|.Technic|
|00000090| 61 6c 20 4e 6f 74 65 73 | 0d 5f 5f 5f 5f 5f 5f 5f |al Notes|._______|
|000000a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000000b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000000c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000000d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000000e0| 5f 5f 5f 5f 5f 5f 0d 20 | 20 20 20 20 20 20 20 20 |______. |        |
|000000f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00000100| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00000110| 20 20 20 20 20 20 20 20 | 20 44 65 76 65 6c 6f 70 |        | Develop|
|00000120| 65 72 20 54 65 63 68 6e | 69 63 61 6c 20 53 75 70 |er Techn|ical Sup|
|00000130| 70 6f 72 74 0d 0d 0d 47 | 53 2f 4f 53 0d 23 34 3a |port...G|S/OS.#4:|
|00000140| 20 20 20 20 41 20 47 53 | 2f 4f 53 20 53 74 61 74 |    A GS|/OS Stat|
|00000150| 65 20 6f 66 20 4d 69 6e | 64 0d 0d 52 65 76 69 73 |e of Min|d..Revis|
|00000160| 65 64 20 62 79 3a 20 20 | 20 20 44 61 76 65 20 4c |ed by:  |  Dave L|
|00000170| 79 6f 6e 73 20 26 20 4d | 61 74 74 20 44 65 61 74 |yons & M|att Deat|
|00000180| 68 65 72 61 67 65 20 20 | 20 20 20 20 20 20 20 20 |herage  |        |
|00000190| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 4a |        |       J|
|000001a0| 75 6c 79 20 31 39 38 39 | 0d 57 72 69 74 74 65 6e |uly 1989|.Written|
|000001b0| 20 62 79 3a 20 20 20 20 | 4d 61 74 74 20 44 65 61 | by:    |Matt Dea|
|000001c0| 74 68 65 72 61 67 65 20 | 20 20 20 20 20 20 20 20 |therage |        |
|000001d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000001e0| 20 20 20 20 20 20 20 20 | 20 20 4a 61 6e 75 61 72 |        |  Januar|
|000001f0| 79 20 31 39 38 39 0d 0d | 54 68 69 73 20 54 65 63 |y 1989..|This Tec|
|00000200| 68 6e 69 63 61 6c 20 4e | 6f 74 65 20 64 69 73 63 |hnical N|ote disc|
|00000210| 75 73 73 65 73 20 47 53 | 2f 4f 53 20 63 6f 6e 63 |usses GS|/OS conc|
|00000220| 65 70 74 73 20 61 6e 64 | 20 70 72 61 63 74 69 63 |epts and| practic|
|00000230| 65 73 2e 0d 43 68 61 6e | 67 65 73 20 73 69 6e 67 |es..Chan|ges sing|
|00000240| 65 20 4a 61 6e 75 61 72 | 79 20 31 39 38 39 3a 20 |e Januar|y 1989: |
|00000250| 20 55 70 64 61 74 65 64 | 20 66 6f 72 20 53 79 73 | Updated| for Sys|
|00000260| 74 65 6d 20 53 6f 66 74 | 77 61 72 65 20 35 2e 30 |tem Soft|ware 5.0|
|00000270| 2e 0d 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |..______|________|
|00000280| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000290| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000002a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000002b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 0d |________|_______.|
|000002c0| 0d 41 6c 74 68 6f 75 67 | 68 20 47 53 2f 4f 53 20 |.Althoug|h GS/OS |
|000002d0| 62 65 61 72 73 20 6d 61 | 6e 79 20 73 69 6d 69 6c |bears ma|ny simil|
|000002e0| 61 72 69 74 69 65 73 20 | 74 6f 20 50 72 6f 44 4f |arities |to ProDO|
|000002f0| 53 2c 20 47 53 2f 4f 53 | 20 69 73 20 61 20 6d 75 |S, GS/OS| is a mu|
|00000300| 63 68 20 77 69 64 65 72 | 2d 0d 72 65 61 63 68 69 |ch wider|-.reachi|
|00000310| 6e 67 20 6f 70 65 72 61 | 74 69 6e 67 20 73 79 73 |ng opera|ting sys|
|00000320| 74 65 6d 2c 20 77 6f 72 | 6b 69 6e 67 20 6e 6f 74 |tem, wor|king not|
|00000330| 20 6f 6e 6c 79 20 77 69 | 74 68 20 6d 75 6c 74 69 | only wi|th multi|
|00000340| 70 6c 65 20 66 69 6c 65 | 20 73 79 73 74 65 6d 73 |ple file| systems|
|00000350| 20 62 75 74 20 0d 61 6c | 73 6f 20 77 69 74 68 20 | but .al|so with |
|00000360| 63 68 61 72 61 63 74 65 | 72 20 64 65 76 69 63 65 |characte|r device|
|00000370| 73 2e 20 20 53 6f 6d 65 | 20 74 68 69 6e 67 73 20 |s.  Some| things |
|00000380| 77 68 69 63 68 20 77 6f | 72 6b 20 75 6e 64 65 72 |which wo|rk under|
|00000390| 20 50 72 6f 44 4f 53 20 | 63 61 75 73 65 20 0d 70 | ProDOS |cause .p|
|000003a0| 72 6f 62 6c 65 6d 73 20 | 75 6e 64 65 72 20 47 53 |roblems |under GS|
|000003b0| 2f 4f 53 2c 20 61 6e 64 | 20 61 70 70 6c 69 63 61 |/OS, and| applica|
|000003c0| 74 69 6f 6e 20 70 72 6f | 67 72 61 6d 6d 65 72 73 |tion pro|grammers|
|000003d0| 20 6e 65 65 64 20 74 6f | 20 62 65 20 61 77 61 72 | need to| be awar|
|000003e0| 65 20 6f 66 20 74 68 65 | 20 0d 64 69 66 66 65 72 |e of the| .differ|
|000003f0| 65 6e 63 65 73 2c 20 70 | 61 72 74 69 63 75 6c 61 |ences, p|articula|
|00000400| 72 6c 79 20 74 68 6f 73 | 65 20 64 65 76 65 6c 6f |rly thos|e develo|
|00000410| 70 69 6e 67 20 74 65 78 | 74 2d 62 61 73 65 64 20 |ping tex|t-based |
|00000420| 70 72 6f 67 72 61 6d 73 | 2e 0d 0d 0d 47 53 2f 4f |programs|....GS/O|
|00000430| 53 20 48 69 6e 74 73 0d | 0d 42 65 20 61 77 61 72 |S Hints.|.Be awar|
|00000440| 65 20 6f 66 20 63 68 61 | 72 61 63 74 65 72 20 64 |e of cha|racter d|
|00000450| 65 76 69 63 65 73 2e 20 | 20 41 20 6c 65 67 61 6c |evices. | A legal|
|00000460| 20 47 53 2f 4f 53 20 70 | 61 74 68 6e 61 6d 65 2c | GS/OS p|athname,|
|00000470| 20 70 65 72 68 61 70 73 | 20 65 6e 74 65 72 65 64 | perhaps| entered|
|00000480| 20 0d 62 79 20 61 20 75 | 73 65 72 20 69 6e 20 72 | .by a u|ser in r|
|00000490| 65 73 70 6f 6e 73 65 20 | 74 6f 20 61 20 70 72 6f |esponse |to a pro|
|000004a0| 6d 70 74 2c 20 63 6f 75 | 6c 64 20 6d 61 70 20 74 |mpt, cou|ld map t|
|000004b0| 6f 20 61 20 63 68 61 72 | 61 63 74 65 72 20 64 65 |o a char|acter de|
|000004c0| 76 69 63 65 2c 20 77 69 | 74 68 20 0d 70 6f 74 65 |vice, wi|th .pote|
|000004d0| 6e 74 69 61 6c 6c 79 20 | 64 69 73 61 73 74 72 6f |ntially |disastro|
|000004e0| 75 73 20 72 65 73 75 6c | 74 73 2e 20 20 45 72 72 |us resul|ts.  Err|
|000004f0| 6f 72 20 24 35 38 2c 20 | 4e 6f 74 20 61 20 42 6c |or $58, |Not a Bl|
|00000500| 6f 63 6b 20 44 65 76 69 | 63 65 2c 20 63 61 6e 20 |ock Devi|ce, can |
|00000510| 70 72 6f 74 65 63 74 20 | 0d 79 6f 75 20 61 67 61 |protect |.you aga|
|00000520| 69 6e 73 74 20 74 68 69 | 73 20 6f 6e 20 6d 61 6e |inst thi|s on man|
|00000530| 79 20 63 61 6c 6c 73 2c | 20 69 6e 63 6c 75 64 69 |y calls,| includi|
|00000540| 6e 67 20 43 72 65 61 74 | 65 2c 20 62 75 74 20 79 |ng Creat|e, but y|
|00000550| 6f 75 20 6d 75 73 74 20 | 73 74 69 6c 6c 20 74 61 |ou must |still ta|
|00000560| 6b 65 20 0d 70 72 65 63 | 61 75 74 69 6f 6e 2e 20 |ke .prec|aution. |
|00000570| 20 44 49 6e 66 6f 20 74 | 65 6c 6c 73 20 79 6f 75 | DInfo t|ells you|
|00000580| 20 69 66 20 61 20 64 65 | 76 69 63 65 20 69 73 20 | if a de|vice is |
|00000590| 61 20 63 68 61 72 61 63 | 74 65 72 20 64 65 76 69 |a charac|ter devi|
|000005a0| 63 65 20 6f 72 20 62 6c | 6f 63 6b 20 0d 64 65 76 |ce or bl|ock .dev|
|000005b0| 69 63 65 3b 20 62 69 74 | 20 73 65 76 65 6e 20 6f |ice; bit| seven o|
|000005c0| 66 20 74 68 65 20 63 68 | 61 72 61 63 74 65 72 69 |f the ch|aracteri|
|000005d0| 73 74 69 63 73 20 77 6f | 72 64 20 69 73 20 73 65 |stics wo|rd is se|
|000005e0| 74 20 69 66 20 74 68 65 | 20 64 65 76 69 63 65 20 |t if the| device |
|000005f0| 69 73 20 61 20 62 6c 6f | 63 6b 20 0d 64 65 76 69 |is a blo|ck .devi|
|00000600| 63 65 2e 0d 0d 44 6f 6e | 27 74 20 70 72 65 70 72 |ce...Don|'t prepr|
|00000610| 6f 63 65 73 73 20 70 61 | 74 68 6e 61 6d 65 73 2e |ocess pa|thnames.|
|00000620| 20 20 41 20 75 73 65 72 | 20 69 6e 70 75 74 20 72 |  A user| input r|
|00000630| 6f 75 74 69 6e 65 20 77 | 68 69 63 68 20 70 72 65 |outine w|hich pre|
|00000640| 76 65 6e 74 73 20 75 73 | 65 72 73 20 0d 66 72 6f |vents us|ers .fro|
|00000650| 6d 20 65 6e 74 65 72 69 | 6e 67 20 70 61 74 68 6e |m enteri|ng pathn|
|00000660| 61 6d 65 73 20 74 68 61 | 74 20 64 6f 6e 27 74 20 |ames tha|t don't |
|00000670| 66 6f 6c 6c 6f 77 20 50 | 72 6f 44 4f 53 20 73 79 |follow P|roDOS sy|
|00000680| 6e 74 61 78 20 6d 61 79 | 20 68 65 6c 70 20 70 72 |ntax may| help pr|
|00000690| 65 76 65 6e 74 20 0d 49 | 6c 6c 65 67 61 6c 20 50 |event .I|llegal P|
|000006a0| 61 74 68 6e 61 6d 65 20 | 53 79 6e 74 61 78 20 65 |athname |Syntax e|
|000006b0| 72 72 6f 72 73 2c 20 62 | 75 74 20 69 74 20 61 6c |rrors, b|ut it al|
|000006c0| 73 6f 20 6b 65 65 70 73 | 20 75 73 65 72 73 20 66 |so keeps| users f|
|000006d0| 72 6f 6d 20 63 72 65 61 | 74 69 6e 67 20 66 69 6c |rom crea|ting fil|
|000006e0| 65 73 20 6f 6e 20 0d 6e | 6f 6e 2d 50 72 6f 44 4f |es on .n|on-ProDO|
|000006f0| 53 20 64 69 73 6b 73 20 | 77 69 74 68 20 61 6e 79 |S disks |with any|
|00000700| 74 68 69 6e 67 20 62 75 | 74 20 50 72 6f 44 4f 53 |thing bu|t ProDOS|
|00000710| 20 70 61 74 68 6e 61 6d | 65 20 73 79 6e 74 61 78 | pathnam|e syntax|
|00000720| 2c 20 61 6e 64 20 69 74 | 20 63 6f 75 6c 64 20 6b |, and it| could k|
|00000730| 65 65 70 20 0d 74 68 65 | 6d 20 66 72 6f 6d 20 61 |eep .the|m from a|
|00000740| 63 63 65 73 73 69 6e 67 | 20 66 69 6c 65 73 20 6f |ccessing| files o|
|00000750| 6e 20 6e 6f 6e 2d 50 72 | 6f 44 4f 53 20 64 69 73 |n non-Pr|oDOS dis|
|00000760| 6b 73 20 77 68 69 63 68 | 20 74 68 65 79 20 63 72 |ks which| they cr|
|00000770| 65 61 74 65 64 20 77 69 | 74 68 20 61 6e 6f 74 68 |eated wi|th anoth|
|00000780| 65 72 20 0d 47 53 2f 4f | 53 20 61 70 70 6c 69 63 |er .GS/O|S applic|
|00000790| 61 74 69 6f 6e 2e 20 20 | 53 69 6e 63 65 20 74 68 |ation.  |Since th|
|000007a0| 65 20 6f 6e 6c 79 20 46 | 53 54 20 77 68 69 63 68 |e only F|ST which|
|000007b0| 20 61 6c 6c 6f 77 65 64 | 20 79 6f 75 20 74 6f 20 | allowed| you to |
|000007c0| 77 72 69 74 65 20 74 6f | 20 61 20 64 65 76 69 63 |write to| a devic|
|000007d0| 65 20 0d 75 6e 64 65 72 | 20 53 79 73 74 65 6d 20 |e .under| System |
|000007e0| 53 6f 66 74 77 61 72 65 | 20 34 2e 30 20 77 61 73 |Software| 4.0 was|
|000007f0| 20 50 72 6f 44 4f 53 2c | 20 79 6f 75 20 64 69 64 | ProDOS,| you did|
|00000800| 6e 27 74 20 73 65 65 20 | 74 68 69 73 20 70 72 6f |n't see |this pro|
|00000810| 62 6c 65 6d 20 72 69 67 | 68 74 20 61 77 61 79 2e |blem rig|ht away.|
|00000820| 20 20 0d 48 6f 77 65 76 | 65 72 2c 20 53 79 73 74 |  .Howev|er, Syst|
|00000830| 65 6d 20 53 6f 66 74 77 | 61 72 65 20 35 2e 30 20 |em Softw|are 5.0 |
|00000840| 69 6e 63 6c 75 64 65 73 | 20 61 6e 20 41 70 70 6c |includes| an Appl|
|00000850| 65 53 68 61 72 65 20 46 | 53 54 20 77 68 69 63 68 |eShare F|ST which|
|00000860| 2c 20 63 6f 6d 70 61 72 | 65 64 20 74 6f 20 0d 50 |, compar|ed to .P|
|00000870| 72 6f 44 4f 53 2c 20 69 | 73 20 66 61 73 74 20 61 |roDOS, i|s fast a|
|00000880| 6e 64 20 6c 6f 6f 73 65 | 20 77 69 74 68 20 70 61 |nd loose| with pa|
|00000890| 74 68 6e 61 6d 65 73 2e | 20 20 22 48 6f 77 20 61 |thnames.|  "How a|
|000008a0| 62 6f 75 74 20 61 6e 20 | 61 6e 74 69 2d 50 72 6f |bout an |anti-Pro|
|000008b0| 44 4f 53 20 6e 61 6d 65 | 3f 22 20 69 73 20 0d 61 |DOS name|?" is .a|
|000008c0| 20 6c 65 67 61 6c 20 41 | 70 70 6c 65 53 68 61 72 | legal A|ppleShar|
|000008d0| 65 20 66 69 6c 65 6e 61 | 6d 65 2e 20 20 54 6f 20 |e filena|me.  To |
|000008e0| 61 6c 6c 6f 77 20 63 6f | 6d 70 61 74 69 62 69 6c |allow co|mpatibil|
|000008f0| 69 74 79 20 77 69 74 68 | 20 70 72 65 73 65 6e 74 |ity with| present|
|00000900| 20 61 6e 64 20 66 75 74 | 75 72 65 20 0d 6e 6f 6e | and fut|ure .non|
|00000910| 2d 50 72 6f 44 4f 53 20 | 46 53 54 73 2c 20 41 70 |-ProDOS |FSTs, Ap|
|00000920| 70 6c 65 20 73 75 67 67 | 65 73 74 73 20 79 6f 75 |ple sugg|ests you|
|00000930| 20 70 61 73 73 20 75 73 | 65 72 2d 65 6e 74 65 72 | pass us|er-enter|
|00000940| 65 64 20 70 61 74 68 6e | 61 6d 65 73 20 64 69 72 |ed pathn|ames dir|
|00000950| 65 63 74 6c 79 20 74 6f | 20 0d 47 53 2f 4f 53 2c |ectly to| .GS/OS,|
|00000960| 20 77 69 74 68 20 6e 6f | 20 61 70 70 6c 69 63 61 | with no| applica|
|00000970| 74 69 6f 6e 20 70 72 65 | 70 72 6f 63 65 73 73 69 |tion pre|processi|
|00000980| 6e 67 2e 0d 0d 52 65 6d | 65 6d 62 65 72 20 74 68 |ng...Rem|ember th|
|00000990| 61 74 20 75 6e 64 65 72 | 20 47 53 2f 4f 53 20 62 |at under| GS/OS b|
|000009a0| 6f 74 68 20 63 6f 6c 6f | 6e 73 20 61 6e 64 20 73 |oth colo|ns and s|
|000009b0| 6c 61 73 68 65 73 20 61 | 72 65 20 76 61 6c 69 64 |lashes a|re valid|
|000009c0| 20 73 65 70 61 72 61 74 | 6f 72 73 2c 20 61 6e 64 | separat|ors, and|
|000009d0| 20 0d 63 6f 6c 6f 6e 73 | 20 63 61 6e 20 6f 6e 6c | .colons| can onl|
|000009e0| 79 20 62 65 20 73 65 70 | 61 72 61 74 6f 72 73 2e |y be sep|arators.|
|000009f0| 20 20 49 6e 20 61 64 64 | 69 74 69 6f 6e 2c 20 61 |  In add|ition, a|
|00000a00| 6c 6c 20 65 69 67 68 74 | 20 62 69 74 73 20 6f 66 |ll eight| bits of|
|00000a10| 20 65 61 63 68 20 62 79 | 74 65 20 6f 66 20 61 20 | each by|te of a |
|00000a20| 0d 70 61 74 68 6e 61 6d | 65 20 61 72 65 20 73 69 |.pathnam|e are si|
|00000a30| 67 6e 69 66 69 63 61 6e | 74 2e 20 20 52 65 66 65 |gnifican|t.  Refe|
|00000a40| 72 20 74 6f 20 47 53 2f | 4f 53 20 52 65 66 65 72 |r to GS/|OS Refer|
|00000a50| 65 6e 63 65 2c 20 56 6f | 6c 75 6d 65 20 31 20 66 |ence, Vo|lume 1 f|
|00000a60| 6f 72 20 6d 6f 72 65 20 | 0d 69 6e 66 6f 72 6d 61 |or more |.informa|
|00000a70| 74 69 6f 6e 20 6f 6e 20 | 47 53 2f 4f 53 20 70 61 |tion on |GS/OS pa|
|00000a80| 74 68 6e 61 6d 65 20 73 | 79 6e 74 61 78 2e 20 20 |thname s|yntax.  |
|00000a90| 55 73 69 6e 67 20 61 6c | 6c 20 65 69 67 68 74 20 |Using al|l eight |
|00000aa0| 62 69 74 73 20 6f 66 20 | 65 61 63 68 20 62 79 74 |bits of |each byt|
|00000ab0| 65 20 6d 61 79 20 0d 62 | 65 20 70 61 72 74 69 63 |e may .b|e partic|
|00000ac0| 75 6c 61 72 6c 79 20 64 | 69 66 66 69 63 75 6c 74 |ularly d|ifficult|
|00000ad0| 20 66 6f 72 20 74 65 78 | 74 2d 62 61 73 65 64 20 | for tex|t-based |
|00000ae0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 73 2c 20 77 68 |applicat|ions, wh|
|00000af0| 69 63 68 20 68 61 76 65 | 20 6e 6f 20 77 61 79 20 |ich have| no way |
|00000b00| 74 6f 20 0d 66 6f 72 63 | 65 20 74 68 65 20 73 74 |to .forc|e the st|
|00000b10| 61 6e 64 61 72 64 20 41 | 70 70 6c 65 20 49 49 20 |andard A|pple II |
|00000b20| 63 68 61 72 61 63 74 65 | 72 20 73 65 74 20 74 6f |characte|r set to|
|00000b30| 20 64 69 73 70 6c 61 79 | 20 63 68 61 72 61 63 74 | display| charact|
|00000b40| 65 72 73 20 73 75 63 68 | 20 61 73 20 73 69 67 6d |ers such| as sigm|
|00000b50| 61 20 0d 6f 72 20 74 68 | 65 20 63 6f 70 79 72 69 |a .or th|e copyri|
|00000b60| 67 68 74 20 73 79 6d 62 | 6f 6c 3b 20 74 68 65 79 |ght symb|ol; they|
|00000b70| 20 63 61 6e 20 66 69 64 | 64 6c 65 20 74 6f 20 67 | can fid|dle to g|
|00000b80| 65 74 20 63 68 61 72 61 | 63 74 65 72 73 20 6c 69 |et chara|cters li|
|00000b90| 6b 65 20 74 68 65 20 73 | 74 65 72 6c 69 6e 67 20 |ke the s|terling |
|00000ba0| 0d 70 6f 75 6e 64 20 73 | 69 67 6e 20 61 6e 64 20 |.pound s|ign and |
|00000bb0| 61 6e 20 41 70 70 6c 65 | 2e 20 20 53 6f 6d 65 20 |an Apple|.  Some |
|00000bc0| 70 72 6f 67 72 61 6d 73 | 20 6d 61 79 20 77 69 73 |programs| may wis|
|00000bd0| 68 20 74 6f 20 61 64 6f | 70 74 20 73 70 65 63 69 |h to ado|pt speci|
|00000be0| 61 6c 20 0d 74 79 70 6f | 67 72 61 70 68 69 63 61 |al .typo|graphica|
|00000bf0| 6c 20 63 6f 6e 76 65 6e | 74 69 6f 6e 73 20 66 6f |l conven|tions fo|
|00000c00| 72 20 74 68 65 73 65 20 | 73 70 65 63 69 61 6c 20 |r these |special |
|00000c10| 63 68 61 72 61 63 74 65 | 72 73 20 77 68 69 6c 65 |characte|rs while|
|00000c20| 20 6f 74 68 65 72 73 20 | 6d 61 79 20 63 68 6f 6f | others |may choo|
|00000c30| 73 65 20 0d 6e 6f 74 20 | 74 6f 20 63 72 65 61 74 |se .not |to creat|
|00000c40| 65 20 66 69 6c 65 73 20 | 77 69 74 68 20 73 75 63 |e files |with suc|
|00000c50| 68 20 63 68 61 72 61 63 | 74 65 72 73 20 69 6e 20 |h charac|ters in |
|00000c60| 74 68 65 69 72 20 6e 61 | 6d 65 73 2e 20 20 54 68 |their na|mes.  Th|
|00000c70| 65 73 65 20 70 72 6f 67 | 72 61 6d 73 20 63 6f 75 |ese prog|rams cou|
|00000c80| 6c 64 20 0d 70 72 65 73 | 65 6e 74 20 74 68 65 20 |ld .pres|ent the |
|00000c90| 75 73 65 72 20 77 69 74 | 68 20 61 20 6c 69 73 74 |user wit|h a list|
|00000ca0| 20 6f 66 20 65 78 69 73 | 74 69 6e 67 20 66 69 6c | of exis|ting fil|
|00000cb0| 65 6e 61 6d 65 73 20 28 | 77 69 74 68 20 73 6f 6d |enames (|with som|
|00000cc0| 65 20 73 75 62 73 74 69 | 74 75 74 69 6f 6e 20 66 |e substi|tution f|
|00000cd0| 6f 72 20 0d 74 68 65 20 | 63 68 61 72 61 63 74 65 |or .the |characte|
|00000ce0| 72 73 20 77 68 69 63 68 | 20 61 72 65 20 75 6e 61 |rs which| are una|
|00000cf0| 76 61 69 6c 61 62 6c 65 | 29 2c 20 77 68 69 6c 65 |vailable|), while|
|00000d00| 20 70 72 6f 76 69 64 69 | 6e 67 20 61 20 6d 65 74 | providi|ng a met|
|00000d10| 68 6f 64 20 6f 66 20 63 | 68 6f 6f 73 69 6e 67 20 |hod of c|hoosing |
|00000d20| 0d 6f 6e 65 2c 20 74 6f | 20 72 65 74 72 69 65 76 |.one, to| retriev|
|00000d30| 65 20 73 75 63 68 20 66 | 69 6c 65 73 2e 20 20 41 |e such f|iles.  A|
|00000d40| 6e 79 20 77 61 79 20 61 | 72 6f 75 6e 64 20 74 68 |ny way a|round th|
|00000d50| 69 73 20 70 72 6f 62 6c | 65 6d 20 66 6f 72 20 61 |is probl|em for a|
|00000d60| 20 74 65 78 74 2d 62 61 | 73 65 64 20 0d 70 72 6f | text-ba|sed .pro|
|00000d70| 67 72 61 6d 20 77 69 6c | 6c 20 62 65 20 6c 65 73 |gram wil|l be les|
|00000d80| 73 20 74 68 61 6e 20 6f | 70 74 69 6d 61 6c 2e 0d |s than o|ptimal..|
|00000d90| 0d 41 76 6f 69 64 20 74 | 68 65 20 54 65 78 74 20 |.Avoid t|he Text |
|00000da0| 54 6f 6f 6c 73 20 61 6e | 64 20 61 6c 6c 20 73 6c |Tools an|d all sl|
|00000db0| 6f 74 20 64 65 70 65 6e | 64 65 6e 63 69 65 73 2e |ot depen|dencies.|
|00000dc0| 20 20 50 72 65 6c 69 6d | 69 6e 61 72 79 20 47 53 |  Prelim|inary GS|
|00000dd0| 2f 4f 53 20 0d 64 6f 63 | 75 6d 65 6e 74 61 74 69 |/OS .doc|umentati|
|00000de0| 6f 6e 20 70 6f 69 6e 74 | 73 20 74 6f 20 61 20 53 |on point|s to a S|
|00000df0| 79 73 74 65 6d 20 53 65 | 72 76 69 63 65 20 63 61 |ystem Se|rvice ca|
|00000e00| 6c 6c 20 6e 61 6d 65 64 | 20 44 59 4e 5f 53 4c 4f |ll named| DYN_SLO|
|00000e10| 54 5f 41 52 42 49 54 45 | 52 2e 20 20 54 68 69 73 |T_ARBITE|R.  This|
|00000e20| 20 0d 6d 65 63 68 61 6e | 69 73 6d 2c 20 77 68 69 | .mechan|ism, whi|
|00000e30| 63 68 20 69 73 20 6e 6f | 74 20 66 75 6c 6c 79 20 |ch is no|t fully |
|00000e40| 69 6d 70 6c 65 6d 65 6e | 74 65 64 20 69 6e 20 53 |implemen|ted in S|
|00000e50| 79 73 74 65 6d 20 53 6f | 66 74 77 61 72 65 20 35 |ystem So|ftware 5|
|00000e60| 2e 30 2c 20 65 76 65 6e | 74 75 61 6c 6c 79 20 0d |.0, even|tually .|
|00000e70| 77 69 6c 6c 20 61 6c 6c | 6f 77 20 74 68 65 20 6f |will all|ow the o|
|00000e80| 70 65 72 61 74 69 6e 67 | 20 73 79 73 74 65 6d 20 |perating| system |
|00000e90| 74 6f 20 75 73 65 20 69 | 6e 74 65 72 6e 61 6c 20 |to use i|nternal |
|00000ea0| 70 6f 72 74 73 20 61 6e | 64 20 65 78 74 65 72 6e |ports an|d extern|
|00000eb0| 61 6c 20 73 6c 6f 74 73 | 20 66 6f 72 20 0d 74 68 |al slots| for .th|
|00000ec0| 65 20 73 61 6d 65 20 22 | 73 6c 6f 74 22 20 69 6e |e same "|slot" in|
|00000ed0| 20 74 68 65 20 73 61 6d | 65 20 73 65 73 73 69 6f | the sam|e sessio|
|00000ee0| 6e 2c 20 69 6e 73 74 65 | 61 64 20 6f 66 20 72 65 |n, inste|ad of re|
|00000ef0| 71 75 69 72 69 6e 67 20 | 74 68 65 20 75 73 65 72 |quiring |the user|
|00000f00| 20 74 6f 20 72 65 62 6f | 6f 74 20 0d 74 68 65 20 | to rebo|ot .the |
|00000f10| 73 79 73 74 65 6d 20 74 | 6f 20 73 61 66 65 6c 79 |system t|o safely|
|00000f20| 20 63 68 61 6e 67 65 20 | 62 65 74 77 65 65 6e 20 | change |between |
|00000f30| 70 6f 72 74 73 20 61 6e | 64 20 73 6c 6f 74 73 2e |ports an|d slots.|
|00000f40| 20 20 41 70 70 6c 69 63 | 61 74 69 6f 6e 73 20 77 |  Applic|ations w|
|00000f50| 68 69 63 68 20 68 61 76 | 65 20 0d 68 61 72 64 2d |hich hav|e .hard-|
|00000f60| 63 6f 64 65 64 20 73 6c | 6f 74 20 64 65 70 65 6e |coded sl|ot depen|
|00000f70| 64 65 6e 63 69 65 73 20 | 28 61 73 20 74 68 65 20 |dencies |(as the |
|00000f80| 54 65 78 74 20 54 6f 6f | 6c 73 20 75 6e 66 6f 72 |Text Too|ls unfor|
|00000f90| 74 75 6e 61 74 65 6c 79 | 20 72 65 71 75 69 72 65 |tunately| require|
|00000fa0| 29 20 6d 61 6b 65 20 0d | 74 68 69 73 20 74 72 61 |) make .|this tra|
|00000fb0| 6e 73 69 74 69 6f 6e 20 | 76 65 72 79 20 64 69 66 |nsition |very dif|
|00000fc0| 66 69 63 75 6c 74 2c 20 | 62 6f 74 68 20 66 6f 72 |ficult, |both for|
|00000fd0| 20 47 53 2f 4f 53 20 61 | 6e 64 20 66 6f 72 20 74 | GS/OS a|nd for t|
|00000fe0| 68 65 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 73 20 |he appli|cations |
|00000ff0| 61 6e 64 20 0d 75 73 65 | 72 73 2e 20 20 57 65 20 |and .use|rs.  We |
|00001000| 72 65 63 6f 6d 6d 65 6e | 64 20 74 68 61 74 20 61 |recommen|d that a|
|00001010| 70 70 6c 69 63 61 74 69 | 6f 6e 73 20 75 73 65 20 |pplicati|ons use |
|00001020| 74 68 65 20 47 53 2f 4f | 53 20 6c 6f 61 64 65 64 |the GS/O|S loaded|
|00001030| 20 61 6e 64 20 67 65 6e | 65 72 61 74 65 64 20 0d | and gen|erated .|
|00001040| 63 68 61 72 61 63 74 65 | 72 20 64 65 76 69 63 65 |characte|r device|
|00001050| 20 64 72 69 76 65 72 73 | 20 66 6f 72 20 74 65 78 | drivers| for tex|
|00001060| 74 20 6f 75 74 70 75 74 | 2e 20 20 41 20 44 49 6e |t output|.  A DIn|
|00001070| 66 6f 20 63 61 6c 6c 20 | 77 69 6c 6c 20 74 65 6c |fo call |will tel|
|00001080| 6c 20 79 6f 75 20 77 68 | 61 74 20 0d 73 6c 6f 74 |l you wh|at .slot|
|00001090| 20 6f 72 20 70 6f 72 74 | 20 61 20 64 72 69 76 65 | or port| a drive|
|000010a0| 72 20 63 6f 6e 74 72 6f | 6c 73 2c 20 61 6e 64 20 |r contro|ls, and |
|000010b0| 77 68 65 74 68 65 72 20 | 6f 72 20 6e 6f 74 20 69 |whether |or not i|
|000010c0| 74 20 69 73 20 61 20 63 | 68 61 72 61 63 74 65 72 |t is a c|haracter|
|000010d0| 20 64 65 76 69 63 65 2e | 0d 0d 41 76 6f 69 64 20 | device.|..Avoid |
|000010e0| 6f 74 68 65 72 20 66 69 | 6c 65 20 73 79 73 74 65 |other fi|le syste|
|000010f0| 6d 20 64 65 70 65 6e 64 | 65 6e 63 69 65 73 2e 20 |m depend|encies. |
|00001100| 20 4d 61 6e 79 20 6f 66 | 20 74 68 65 20 74 68 69 | Many of| the thi|
|00001110| 6e 67 73 20 50 72 6f 44 | 4f 53 20 0d 70 72 6f 67 |ngs ProD|OS .prog|
|00001120| 72 61 6d 6d 65 72 73 20 | 61 72 65 20 75 73 65 64 |rammers |are used|
|00001130| 20 74 6f 20 61 73 20 66 | 61 63 74 73 20 6f 66 20 | to as f|acts of |
|00001140| 6c 69 66 65 20 6a 75 73 | 74 20 61 72 65 20 6e 6f |life jus|t are no|
|00001150| 74 20 74 72 75 65 20 61 | 6e 79 20 6c 6f 6e 67 65 |t true a|ny longe|
|00001160| 72 2e 20 20 46 6f 72 20 | 0d 65 78 61 6d 70 6c 65 |r.  For |.example|
|00001170| 2c 20 66 69 6c 65 6e 61 | 6d 65 73 20 64 6f 6e 27 |, filena|mes don'|
|00001180| 74 20 68 61 76 65 20 74 | 6f 20 62 65 20 31 35 20 |t have t|o be 15 |
|00001190| 63 68 61 72 61 63 74 65 | 72 73 20 6f 72 20 6c 65 |characte|rs or le|
|000011a0| 73 73 20 75 6e 64 65 72 | 20 47 53 2f 4f 53 2e 20 |ss under| GS/OS. |
|000011b0| 20 57 68 65 6e 20 0d 6d | 61 6b 69 6e 67 20 63 6c | When .m|aking cl|
|000011c0| 61 73 73 20 6f 6e 65 20 | 63 61 6c 6c 73 2c 20 47 |ass one |calls, G|
|000011d0| 53 2f 4f 53 20 77 69 6c | 6c 20 74 65 6c 6c 20 79 |S/OS wil|l tell y|
|000011e0| 6f 75 20 69 66 20 79 6f | 75 20 64 6f 6e 27 74 20 |ou if yo|u don't |
|000011f0| 68 61 76 65 20 65 6e 6f | 75 67 68 20 72 6f 6f 6d |have eno|ugh room|
|00001200| 20 66 6f 72 20 0d 74 68 | 65 20 70 61 74 68 6e 61 | for .th|e pathna|
|00001210| 6d 65 20 62 79 20 72 65 | 74 75 72 6e 69 6e 67 20 |me by re|turning |
|00001220| 61 20 42 75 66 66 65 72 | 20 54 6f 6f 20 53 6d 61 |a Buffer| Too Sma|
|00001230| 6c 6c 20 65 72 72 6f 72 | 20 28 24 34 46 29 2e 20 |ll error| ($4F). |
|00001240| 20 41 76 6f 69 64 69 6e | 67 20 66 69 6c 65 20 0d | Avoidin|g file .|
|00001250| 73 79 73 74 65 6d 20 64 | 65 70 65 6e 64 65 6e 63 |system d|ependenc|
|00001260| 69 65 73 20 6d 65 61 6e | 73 20 68 61 6e 64 6c 69 |ies mean|s handli|
|00001270| 6e 67 20 74 68 69 73 20 | 65 72 72 6f 72 20 69 6e |ng this |error in|
|00001280| 74 65 6c 6c 69 67 65 6e | 74 6c 79 3a 20 20 69 66 |telligen|tly:  if|
|00001290| 20 79 6f 75 20 72 65 63 | 65 69 76 65 20 0d 69 74 | you rec|eive .it|
|000012a0| 2c 20 61 6c 6c 6f 63 61 | 74 65 20 6d 6f 72 65 20 |, alloca|te more |
|000012b0| 73 70 61 63 65 20 66 6f | 72 20 74 68 65 20 62 75 |space fo|r the bu|
|000012c0| 66 66 65 72 20 61 6e 64 | 20 74 72 79 20 74 68 65 |ffer and| try the|
|000012d0| 20 63 61 6c 6c 20 61 67 | 61 69 6e 2e 20 20 47 53 | call ag|ain.  GS|
|000012e0| 2f 4f 53 20 77 69 6c 6c | 20 0d 74 65 6c 6c 20 79 |/OS will| .tell y|
|000012f0| 6f 75 20 68 6f 77 20 6d | 75 63 68 20 73 70 61 63 |ou how m|uch spac|
|00001300| 65 20 69 73 20 6e 65 65 | 64 65 64 2e 20 20 49 66 |e is nee|ded.  If|
|00001310| 20 79 6f 75 20 61 62 73 | 6f 6c 75 74 65 6c 79 20 | you abs|olutely |
|00001320| 6d 75 73 74 20 68 61 72 | 64 20 63 6f 64 65 20 0d |must har|d code .|
|00001330| 70 61 74 68 6e 61 6d 65 | 73 2c 20 73 75 63 68 20 |pathname|s, such |
|00001340| 61 73 20 76 6f 6c 75 6d | 65 20 6e 61 6d 65 73 2c |as volum|e names,|
|00001350| 20 62 65 20 73 75 72 65 | 20 74 6f 20 75 73 65 20 | be sure| to use |
|00001360| 74 68 65 20 63 6f 6c 6f | 6e 20 61 73 20 74 68 65 |the colo|n as the|
|00001370| 20 73 65 70 61 72 61 74 | 6f 72 2c 20 0d 62 65 63 | separat|or, .bec|
|00001380| 61 75 73 65 20 69 66 20 | 79 6f 75 20 64 6f 20 6e |ause if |you do n|
|00001390| 6f 74 2c 20 66 69 6c 65 | 6e 61 6d 65 73 20 77 69 |ot, file|names wi|
|000013a0| 74 68 20 73 6c 61 73 68 | 65 73 20 77 69 6c 6c 20 |th slash|es will |
|000013b0| 63 61 75 73 65 20 70 72 | 6f 62 6c 65 6d 73 2e 20 |cause pr|oblems. |
|000013c0| 20 53 69 6d 69 6c 61 72 | 6c 79 2c 20 0d 64 6f 6e | Similar|ly, .don|
|000013d0| 27 74 20 61 73 73 75 6d | 65 20 61 6e 79 20 6f 66 |'t assum|e any of|
|000013e0| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 3a 0d | the fol|lowing:.|
|000013f0| 0d 20 20 6f 20 20 54 68 | 65 72 65 20 63 61 6e 20 |.  o  Th|ere can |
|00001400| 6f 6e 6c 79 20 62 65 20 | 35 31 20 66 69 6c 65 73 |only be |51 files|
|00001410| 20 69 6e 20 74 68 65 20 | 76 6f 6c 75 6d 65 20 64 | in the |volume d|
|00001420| 69 72 65 63 74 6f 72 79 | 0d 20 20 6f 20 20 41 6c |irectory|.  o  Al|
|00001430| 6c 20 64 65 76 69 63 65 | 73 20 61 72 65 20 6e 61 |l device|s are na|
|00001440| 6d 65 64 20 22 2e 44 6e | 2c 22 20 77 68 65 72 65 |med ".Dn|," where|
|00001450| 20 6e 20 69 73 20 74 68 | 65 20 64 65 76 69 63 65 | n is th|e device|
|00001460| 20 6e 75 6d 62 65 72 0d | 20 20 6f 20 20 41 6c 6c | number.|  o  All|
|00001470| 20 62 6c 6f 63 6b 73 20 | 61 72 65 20 35 31 32 20 | blocks |are 512 |
|00001480| 62 79 74 65 73 20 6c 6f | 6e 67 0d 20 20 6f 20 20 |bytes lo|ng.  o  |
|00001490| 41 6c 6c 20 64 65 76 69 | 63 65 73 20 61 72 65 20 |All devi|ces are |
|000014a0| 62 6c 6f 63 6b 20 64 65 | 76 69 63 65 73 0d 20 20 |block de|vices.  |
|000014b0| 6f 20 20 41 6e 79 20 6f | 74 68 65 72 20 50 72 6f |o  Any o|ther Pro|
|000014c0| 44 4f 53 2d 73 70 65 63 | 69 66 69 63 20 63 68 61 |DOS-spec|ific cha|
|000014d0| 72 61 63 74 65 72 69 73 | 74 69 63 73 0d 0d 44 6f |racteris|tics..Do|
|000014e0| 6e 27 74 20 68 6f 67 20 | 61 6c 6c 20 6f 66 20 74 |n't hog |all of t|
|000014f0| 68 65 20 6d 65 6d 6f 72 | 79 2e 20 20 57 68 69 6c |he memor|y.  Whil|
|00001500| 65 20 74 68 69 73 20 69 | 73 20 6e 65 76 65 72 20 |e this i|s never |
|00001510| 61 20 67 6f 6f 64 20 69 | 64 65 61 20 6f 6e 20 74 |a good i|dea on t|
|00001520| 68 65 20 0d 49 49 47 53 | 2c 20 69 74 27 73 20 65 |he .IIGS|, it's e|
|00001530| 76 65 6e 20 77 6f 72 73 | 65 20 75 6e 64 65 72 20 |ven wors|e under |
|00001540| 47 53 2f 4f 53 2e 20 20 | 54 6f 20 70 72 6f 63 65 |GS/OS.  |To proce|
|00001550| 73 73 20 74 68 69 6e 67 | 73 20 6c 69 6b 65 20 70 |ss thing|s like p|
|00001560| 61 74 68 6e 61 6d 65 73 | 2c 20 47 53 2f 4f 53 20 |athnames|, GS/OS |
|00001570| 0d 61 6c 6c 6f 63 61 74 | 65 73 20 6d 65 6d 6f 72 |.allocat|es memor|
|00001580| 79 20 74 68 72 6f 75 67 | 68 20 74 68 65 20 4d 65 |y throug|h the Me|
|00001590| 6d 6f 72 79 20 4d 61 6e | 61 67 65 72 2e 20 20 49 |mory Man|ager.  I|
|000015a0| 66 20 79 6f 75 27 76 65 | 20 61 6c 6c 6f 63 61 74 |f you've| allocat|
|000015b0| 65 64 20 61 6c 6c 20 6f | 66 20 0d 61 76 61 69 6c |ed all o|f .avail|
|000015c0| 61 62 6c 65 20 6d 65 6d | 6f 72 79 20 28 69 2e 65 |able mem|ory (i.e|
|000015d0| 2e 2c 20 66 6f 72 20 61 | 20 64 69 73 6b 20 63 6f |., for a| disk co|
|000015e0| 70 79 20 70 72 6f 63 65 | 64 75 72 65 29 2c 20 47 |py proce|dure), G|
|000015f0| 53 2f 4f 53 20 77 69 6c | 6c 20 62 65 20 66 6f 72 |S/OS wil|l be for|
|00001600| 63 65 64 20 74 6f 20 0d | 72 65 74 75 72 6e 20 61 |ced to .|return a|
|00001610| 6e 20 4f 75 74 20 6f 66 | 20 4d 65 6d 6f 72 79 20 |n Out of| Memory |
|00001620| 65 72 72 6f 72 20 28 24 | 35 34 29 2e 20 20 49 66 |error ($|54).  If|
|00001630| 20 74 68 65 20 63 6f 6e | 64 69 74 69 6f 6e 20 69 | the con|dition i|
|00001640| 73 20 73 6f 20 73 65 76 | 65 72 65 20 74 68 61 74 |s so sev|ere that|
|00001650| 20 47 53 2f 4f 53 20 0d | 63 61 6e 20 6e 6f 20 6c | GS/OS .|can no l|
|00001660| 6f 6e 67 65 72 20 66 75 | 6e 63 74 69 6f 6e 2c 20 |onger fu|nction, |
|00001670| 69 74 20 77 69 6c 6c 20 | 72 65 74 75 72 6e 20 61 |it will |return a|
|00001680| 20 66 61 74 61 6c 20 47 | 53 2f 4f 53 20 65 72 72 | fatal G|S/OS err|
|00001690| 6f 72 20 77 69 74 68 20 | 61 6e 20 49 44 20 3d 20 |or with |an ID = |
|000016a0| 32 2c 20 61 6e 64 20 0d | 74 68 65 20 75 73 65 72 |2, and .|the user|
|000016b0| 20 77 69 6c 6c 20 62 65 | 20 61 73 6b 65 64 20 74 | will be| asked t|
|000016c0| 6f 20 72 65 73 74 61 72 | 74 20 74 68 65 20 73 79 |o restar|t the sy|
|000016d0| 73 74 65 6d 2e 0d 0d 28 | 41 20 63 6f 6d 6d 6f 6e |stem...(|A common|
|000016e0| 20 63 61 75 73 65 20 6f | 66 20 66 61 74 61 6c 20 | cause o|f fatal |
|000016f0| 47 53 2f 4f 53 20 65 72 | 72 6f 72 20 32 20 64 75 |GS/OS er|ror 2 du|
|00001700| 72 69 6e 67 20 64 65 76 | 65 6c 6f 70 6d 65 6e 74 |ring dev|elopment|
|00001710| 20 69 73 20 75 73 69 6e | 67 20 61 20 6c 65 6e 67 | is usin|g a leng|
|00001720| 74 68 20 0d 62 79 74 65 | 20 69 6e 73 74 65 61 64 |th .byte| instead|
|00001730| 20 6f 66 20 61 20 6c 65 | 6e 67 74 68 20 77 6f 72 | of a le|ngth wor|
|00001740| 64 20 6f 6e 20 61 20 63 | 6c 61 73 73 20 6f 6e 65 |d on a c|lass one|
|00001750| 20 73 74 72 69 6e 67 2e | 20 20 44 6f 69 6e 67 20 | string.|  Doing |
|00001760| 73 6f 20 61 6c 6d 6f 73 | 74 20 61 6c 77 61 79 73 |so almos|t always|
|00001770| 20 0d 63 61 75 73 65 73 | 20 74 68 65 20 66 69 72 | .causes| the fir|
|00001780| 73 74 20 77 6f 72 64 20 | 74 6f 20 62 65 20 67 72 |st word |to be gr|
|00001790| 65 61 74 65 72 20 74 68 | 61 6e 20 38 4b 2c 20 77 |eater th|an 8K, w|
|000017a0| 68 69 63 68 20 69 73 20 | 74 68 65 20 6d 61 78 69 |hich is |the maxi|
|000017b0| 6d 75 6d 20 6c 65 6e 67 | 74 68 20 6f 66 20 0d 70 |mum leng|th of .p|
|000017c0| 61 74 68 6e 61 6d 65 73 | 20 75 6e 64 65 72 20 47 |athnames| under G|
|000017d0| 53 2f 4f 53 2e 20 20 47 | 53 2f 4f 53 20 74 68 65 |S/OS.  G|S/OS the|
|000017e0| 6e 20 64 69 65 73 20 66 | 6f 72 20 79 6f 75 72 20 |n dies f|or your |
|000017f0| 65 6e 6a 6f 79 6d 65 6e | 74 2c 20 61 73 20 69 74 |enjoymen|t, as it|
|00001800| 20 69 73 20 75 6e 61 62 | 6c 65 20 74 6f 20 0d 61 | is unab|le to .a|
|00001810| 6c 6c 6f 63 61 74 65 20 | 74 68 65 20 6d 65 6d 6f |llocate |the memo|
|00001820| 72 79 20 66 6f 72 20 74 | 68 65 20 70 61 74 68 6e |ry for t|he pathn|
|00001830| 61 6d 65 20 62 65 63 61 | 75 73 65 20 69 74 27 73 |ame beca|use it's|
|00001840| 20 74 6f 6f 20 62 69 67 | 2c 20 65 76 65 6e 20 69 | too big|, even i|
|00001850| 66 20 6d 6f 72 65 20 74 | 68 61 6e 20 0d 38 4b 20 |f more t|han .8K |
|00001860| 69 73 20 61 76 61 69 6c | 61 62 6c 65 2e 29 0d 0d |is avail|able.)..|
|00001870| 48 61 72 64 20 63 6f 64 | 65 20 61 73 20 6c 69 74 |Hard cod|e as lit|
|00001880| 74 6c 65 20 61 73 20 70 | 6f 73 73 69 62 6c 65 2e |tle as p|ossible.|
|00001890| 20 20 45 76 65 6e 20 73 | 65 65 6d 69 6e 67 6c 79 |  Even s|eemingly|
|000018a0| 20 73 74 61 74 69 63 20 | 74 68 69 6e 67 73 20 6c | static |things l|
|000018b0| 69 6b 65 20 0d 64 65 76 | 69 63 65 20 6e 61 6d 65 |ike .dev|ice name|
|000018c0| 73 20 73 68 6f 75 6c 64 | 20 6e 6f 74 20 62 65 20 |s should| not be |
|000018d0| 68 61 72 64 20 63 6f 64 | 65 64 2c 20 73 69 6e 63 |hard cod|ed, sinc|
|000018e0| 65 20 61 20 6e 65 77 20 | 6c 6f 61 64 65 64 20 64 |e a new |loaded d|
|000018f0| 72 69 76 65 72 20 63 6f | 75 6c 64 20 63 68 61 6e |river co|uld chan|
|00001900| 67 65 20 0d 74 68 65 20 | 6e 61 6d 65 20 6f 66 20 |ge .the |name of |
|00001910| 74 68 65 20 73 61 6d 65 | 20 64 65 76 69 63 65 20 |the same| device |
|00001920| 61 74 20 61 6e 79 20 74 | 69 6d 65 2e 20 20 41 6c |at any t|ime.  Al|
|00001930| 73 6f 2c 20 69 74 20 6d | 61 79 20 62 65 20 70 6f |so, it m|ay be po|
|00001940| 73 73 69 62 6c 65 20 69 | 6e 20 74 68 65 20 0d 66 |ssible i|n the .f|
|00001950| 75 74 75 72 65 20 66 6f | 72 20 75 73 65 72 73 20 |uture fo|r users |
|00001960| 74 6f 20 72 65 6e 61 6d | 65 20 64 65 76 69 63 65 |to renam|e device|
|00001970| 73 2e 0d 0d 4f 6e 6c 79 | 20 61 73 6b 20 66 6f 72 |s...Only| ask for|
|00001980| 20 74 68 65 20 61 63 63 | 65 73 73 20 79 6f 75 20 | the acc|ess you |
|00001990| 6e 65 65 64 2e 20 20 49 | 66 20 79 6f 75 27 72 65 |need.  I|f you're|
|000019a0| 20 6a 75 73 74 20 67 6f | 69 6e 67 20 74 6f 20 72 | just go|ing to r|
|000019b0| 65 61 64 20 61 20 66 69 | 6c 65 2c 20 0d 6d 61 6b |ead a fi|le, .mak|
|000019c0| 65 20 61 20 63 61 6c 6c | 20 74 6f 20 4f 70 65 6e |e a call| to Open|
|000019d0| 20 74 68 65 20 66 69 6c | 65 20 77 69 74 68 20 72 | the fil|e with r|
|000019e0| 65 61 64 20 70 65 72 6d | 69 73 73 69 6f 6e 20 6f |ead perm|ission o|
|000019f0| 6e 6c 79 2e 20 20 49 6e | 20 66 69 6c 65 20 73 79 |nly.  In| file sy|
|00001a00| 73 74 65 6d 73 20 77 68 | 65 72 65 20 0d 61 63 63 |stems wh|ere .acc|
|00001a10| 65 73 73 20 70 72 69 76 | 69 6c 65 67 65 73 20 6d |ess priv|ileges m|
|00001a20| 65 61 6e 20 6d 6f 72 65 | 20 74 68 61 6e 20 74 68 |ean more| than th|
|00001a30| 65 79 20 74 72 61 64 69 | 74 69 6f 6e 61 6c 6c 79 |ey tradi|tionally|
|00001a40| 20 68 61 76 65 20 69 6e | 20 50 72 6f 44 4f 53 20 | have in| ProDOS |
|00001a50| 28 77 68 65 72 65 20 0d | 74 68 69 6e 67 73 20 61 |(where .|things a|
|00001a60| 72 65 20 75 73 75 61 6c | 6c 79 20 22 4c 6f 63 6b |re usual|ly "Lock|
|00001a70| 65 64 22 20 6f 72 20 22 | 55 6e 6c 6f 63 6b 65 64 |ed" or "|Unlocked|
|00001a80| 22 29 2c 20 74 68 69 73 | 20 63 6f 75 6c 64 20 73 |"), this| could s|
|00001a90| 61 76 65 20 73 6f 6d 65 | 20 74 72 6f 75 62 6c 65 |ave some| trouble|
|00001aa0| 2e 20 20 46 6f 72 20 0d | 65 78 61 6d 70 6c 65 2c |.  For .|example,|
|00001ab0| 20 41 70 70 6c 65 53 68 | 61 72 65 20 61 6c 6c 6f | AppleSh|are allo|
|00001ac0| 77 73 20 74 68 65 20 73 | 61 6d 65 20 66 69 6c 65 |ws the s|ame file|
|00001ad0| 20 74 6f 20 62 65 20 6f | 70 65 6e 65 64 20 6d 75 | to be o|pened mu|
|00001ae0| 6c 74 69 70 6c 65 20 74 | 69 6d 65 73 20 61 73 20 |ltiple t|imes as |
|00001af0| 6c 6f 6e 67 20 0d 61 73 | 20 65 61 63 68 20 6f 70 |long .as| each op|
|00001b00| 65 6e 20 69 73 20 77 69 | 74 68 20 72 65 61 64 2d |en is wi|th read-|
|00001b10| 6f 6e 6c 79 20 61 63 63 | 65 73 73 2e 20 20 49 66 |only acc|ess.  If|
|00001b20| 20 79 6f 75 72 20 70 72 | 6f 67 72 61 6d 20 69 73 | your pr|ogram is|
|00001b30| 20 6f 6e 6c 79 20 67 6f | 69 6e 67 20 74 6f 20 72 | only go|ing to r|
|00001b40| 65 61 64 20 0d 61 20 66 | 69 6c 65 2c 20 6f 70 65 |ead .a f|ile, ope|
|00001b50| 6e 69 6e 67 20 69 74 20 | 77 69 74 68 20 72 65 61 |ning it |with rea|
|00001b60| 64 20 61 6e 64 20 77 72 | 69 74 65 20 61 63 63 65 |d and wr|ite acce|
|00001b70| 73 73 20 6e 65 65 64 6c | 65 73 73 6c 79 20 64 65 |ss needl|essly de|
|00001b80| 6e 69 65 73 20 6f 74 68 | 65 72 73 20 6f 6e 20 74 |nies oth|ers on t|
|00001b90| 68 65 20 0d 73 65 72 76 | 65 72 20 61 63 63 65 73 |he .serv|er acces|
|00001ba0| 73 20 74 6f 20 74 68 65 | 20 66 69 6c 65 2e 0d 0d |s to the| file...|
|00001bb0| 43 6f 70 79 20 61 6c 6c | 20 47 53 2f 4f 53 20 69 |Copy all| GS/OS i|
|00001bc0| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 77 69 74 68 20 |nformati|on with |
|00001bd0| 66 69 6c 65 73 2e 20 20 | 41 70 70 6c 69 63 61 74 |files.  |Applicat|
|00001be0| 69 6f 6e 73 20 74 68 61 | 74 20 63 6f 70 79 20 66 |ions tha|t copy f|
|00001bf0| 69 6c 65 73 20 0d 6e 65 | 65 64 20 74 6f 20 64 6f |iles .ne|ed to do|
|00001c00| 20 6d 6f 72 65 20 74 68 | 61 6e 20 63 6f 70 79 20 | more th|an copy |
|00001c10| 74 68 65 20 64 61 74 61 | 20 66 6f 72 6b 20 6f 66 |the data| fork of|
|00001c20| 20 74 68 65 20 66 69 6c | 65 2e 20 20 49 66 20 74 | the fil|e.  If t|
|00001c30| 68 65 20 66 69 6c 65 20 | 69 73 20 65 78 74 65 6e |he file |is exten|
|00001c40| 64 65 64 2c 20 0d 74 68 | 65 20 72 65 73 6f 75 72 |ded, .th|e resour|
|00001c50| 63 65 20 66 6f 72 6b 20 | 6f 66 20 74 68 65 20 66 |ce fork |of the f|
|00001c60| 69 6c 65 20 73 68 6f 75 | 6c 64 20 62 65 20 63 6f |ile shou|ld be co|
|00001c70| 70 69 65 64 20 61 73 20 | 77 65 6c 6c 2e 20 20 49 |pied as |well.  I|
|00001c80| 6e 20 61 64 64 69 74 69 | 6f 6e 2c 20 77 68 65 6e |n additi|on, when|
|00001c90| 20 0d 72 65 71 75 65 73 | 74 65 64 2c 20 65 61 63 | .reques|ted, eac|
|00001ca0| 68 20 46 53 54 20 72 65 | 74 75 72 6e 73 20 61 6e |h FST re|turns an|
|00001cb0| 20 6f 70 74 69 6f 6e 5f | 6c 69 73 74 20 74 68 61 | option_|list tha|
|00001cc0| 74 20 63 6f 6e 74 61 69 | 6e 73 20 69 6e 66 6f 72 |t contai|ns infor|
|00001cd0| 6d 61 74 69 6f 6e 20 73 | 70 65 63 69 66 69 63 20 |mation s|pecific |
|00001ce0| 0d 74 6f 20 74 68 65 20 | 68 6f 73 74 20 66 69 6c |.to the |host fil|
|00001cf0| 65 20 73 79 73 74 65 6d | 20 74 68 61 74 20 47 53 |e system| that GS|
|00001d00| 2f 4f 53 20 64 6f 65 73 | 20 6e 6f 74 20 75 73 65 |/OS does| not use|
|00001d10| 20 28 69 2e 65 2e 2c 20 | 41 70 70 6c 65 53 68 61 | (i.e., |AppleSha|
|00001d20| 72 65 27 73 20 0d 6f 70 | 74 69 6f 6e 5f 6c 69 73 |re's .op|tion_lis|
|00001d30| 74 20 69 6e 63 6c 75 64 | 65 73 20 46 69 6e 64 65 |t includ|es Finde|
|00001d40| 72 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 61 6e |r inform|ation an|
|00001d50| 64 20 61 63 63 65 73 73 | 20 70 72 69 76 69 6c 65 |d access| privile|
|00001d60| 67 65 73 29 2e 20 20 43 | 61 6c 6c 73 20 74 6f 20 |ges).  C|alls to |
|00001d70| 0d 47 65 74 46 69 6c 65 | 49 6e 66 6f 20 61 6e 64 |.GetFile|Info and|
|00001d80| 20 4f 70 65 6e 20 63 61 | 6e 20 72 65 74 75 72 6e | Open ca|n return|
|00001d90| 20 74 68 65 20 6f 70 74 | 69 6f 6e 5f 6c 69 73 74 | the opt|ion_list|
|00001da0| 2c 20 77 68 69 6c 65 20 | 61 20 63 61 6c 6c 20 74 |, while |a call t|
|00001db0| 6f 20 53 65 74 46 69 6c | 65 49 6e 66 6f 20 0d 63 |o SetFil|eInfo .c|
|00001dc0| 61 6e 20 73 65 74 20 69 | 74 2e 20 20 41 6e 20 46 |an set i|t.  An F|
|00001dd0| 53 54 20 77 69 6c 6c 20 | 6e 6f 74 20 73 65 74 20 |ST will |not set |
|00001de0| 70 61 72 61 6d 65 74 65 | 72 73 20 69 6e 20 74 68 |paramete|rs in th|
|00001df0| 65 20 6f 70 74 69 6f 6e | 5f 6c 69 73 74 20 77 68 |e option|_list wh|
|00001e00| 69 63 68 20 73 68 6f 75 | 6c 64 20 0d 6e 6f 74 20 |ich shou|ld .not |
|00001e10| 62 65 20 61 6c 74 65 72 | 65 64 20 28 6a 75 73 74 |be alter|ed (just|
|00001e20| 20 61 73 20 53 65 74 46 | 69 6c 65 49 6e 66 6f 20 | as SetF|ileInfo |
|00001e30| 73 6b 69 70 73 20 74 68 | 65 20 45 4f 46 20 66 69 |skips th|e EOF fi|
|00001e40| 65 6c 64 73 20 69 6e 20 | 47 65 74 46 69 6c 65 49 |elds in |GetFileI|
|00001e50| 6e 66 6f 20 0d 72 65 63 | 6f 72 64 73 29 2e 20 20 |nfo .rec|ords).  |
|00001e60| 54 6f 20 65 6e 73 75 72 | 65 20 74 68 61 74 20 74 |To ensur|e that t|
|00001e70| 68 65 20 64 75 70 6c 69 | 63 61 74 65 20 68 61 73 |he dupli|cate has|
|00001e80| 20 61 73 20 6d 75 63 68 | 20 68 6f 73 74 20 66 69 | as much| host fi|
|00001e90| 6c 65 20 73 79 73 74 65 | 6d 20 0d 69 6e 66 6f 72 |le syste|m .infor|
|00001ea0| 6d 61 74 69 6f 6e 20 66 | 72 6f 6d 20 74 68 65 20 |mation f|rom the |
|00001eb0| 6f 72 69 67 69 6e 61 6c | 20 61 73 20 63 61 6e 20 |original| as can |
|00001ec0| 72 65 61 73 6f 6e 61 62 | 6c 79 20 62 65 20 74 72 |reasonab|ly be tr|
|00001ed0| 61 6e 73 66 65 72 72 65 | 64 2c 20 61 6c 77 61 79 |ansferre|d, alway|
|00001ee0| 73 20 63 6f 70 79 20 0d | 74 68 65 20 6f 70 74 69 |s copy .|the opti|
|00001ef0| 6f 6e 5f 6c 69 73 74 2e | 0d 0d 0d 46 75 72 74 68 |on_list.|...Furth|
|00001f00| 65 72 20 52 65 66 65 72 | 65 6e 63 65 0d 5f 5f 5f |er Refer|ence.___|
|00001f10| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001f20| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001f30| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001f40| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00001f50| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0d 20 20 20 20 6f |________|__.    o|
|00001f60| 20 20 20 20 47 53 2f 4f | 53 20 52 65 66 65 72 65 |    GS/O|S Refere|
|00001f70| 6e 63 65 2c 20 56 6f 6c | 75 6d 65 73 20 31 20 61 |nce, Vol|umes 1 a|
|00001f80| 6e 64 20 32 00 00 00 00 | 00 00 00 00 00 00 00 00 |nd 2....|........|
|00001f90| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001fa0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001fb0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001fc0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001fd0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001fe0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001ff0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002000| 00 00 01 00 00 00 01 4c | 00 00 00 4c 00 00 00 32 |.......L|...L...2|
|00002010| 61 6c 77 61 79 73 20 63 | 6f 70 79 20 0d 74 68 65 |always c|opy .the|
|00002020| 20 6f 70 74 69 6f 6e 5f | 6c 69 73 74 2e 0d 0d 0d | option_|list....|
|00002030| 18 31 2e 20 44 44 49 4e | 49 54 45 78 70 61 6e 64 |.1. DDIN|ITExpand|
|00002040| 54 65 6d 70 46 69 6c 65 | 20 70 02 00 00 00 44 44 |TempFile| p....DD|
|00002050| 00 00 44 44 54 4d 44 44 | 41 50 01 00 00 00 00 80 |..DDTMDD|AP......|
|00002060| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002070| 00 00 a5 ca d0 b1 00 00 | 1f 04 00 00 01 7e 72 64 |........|.....~rd|
|00002080| 20 43 68 69 63 61 67 6f | 01 20 01 20 01 20 01 20 | Chicago|. . . . |
|00002090| 00 00 00 20 00 4c 14 74 | 00 00 00 28 00 00 02 00 |... .L.t|...(....|
|000020a0| 00 00 00 08 00 00 00 20 | 00 00 3f 3c 00 01 a9 f0 |....... |..?<....|
|000020b0| 00 00 00 80 00 4c 14 74 | 00 4c 00 00 00 4d 49 fe |.....L.t|.L...MI.|
|000020c0| 00 00 a9 d4 00 69 00 03 | 00 69 26 62 00 69 2e ea |.....i..|.i&b.i..|
|000020d0| 00 69 00 03 00 69 58 fa | 00 69 5d 32 00 69 00 03 |.i...iX.|.i]2.i..|
|000020e0| 00 69 7e 1a 00 69 8b 20 | 00 69 00 03 00 69 ae a8 |.i~..i. |.i...i..|
|000020f0| 00 69 c1 44 00 69 00 03 | 00 69 dd 72 00 69 f3 2a |.i.D.i..|.i.r.i.*|
|00002100| 00 00 00 48 00 09 4d 6f | 6e 61 63 6f 00 74 20 20 |...H..Mo|naco.t  |
|00002110| 20 20 4a 75 6c 79 20 31 | 39 38 39 0d 0d 0d 0d 20 |  July 1|989.... |
|00002120| 20 20 20 47 53 2f 00 06 | 00 04 00 3c 00 24 01 dd |   GS/..|...<.$..|
|00002130| 02 3d 00 3c 00 24 01 dd | 02 3d a1 16 1c d9 00 00 |.=.<.$..|.=......|
|00002140| 00 00 00 00 00 00 00 00 | 00 00 01 00 00 00 01 00 |........|........|
|00002150| 00 00 01 4c 00 00 00 4c | 00 00 00 32 00 5c 15 a4 |...L...L|...2.\..|
|00002160| 09 8e 00 00 00 1c 00 32 | 00 00 4d 50 53 52 00 00 |.......2|..MPSR..|
|00002170| 00 0a 03 ed ff ff 00 00 | 00 00 00 5d ae b0 00 00 |........|...]....|
+--------+-------------------------+-------------------------+--------+--------+